home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr05 / wnbff15.zip / WINBIFF.TXT < prev   
Text File  |  1993-06-26  |  6KB  |  130 lines
  1.  
  2. WinBiff 1.5 - (C) Copyright 1992-93, Paul A. Steckler
  3. ------------------------------------------------------
  4.  
  5. WinBiff is a Windows 3.x version of the well-known Un*x biff 
  6. program, designed for use in conjunction with mail delivery 
  7. programs such as UUPC/extended, Waffle, and sendmail.
  8.  
  9. INSTALLING WINBIFF
  10. ------------------
  11.  
  12. Copy the file WINBIFF.EXE to any directory listed in your PATH.
  13. Typically, users keep WINBIFF.EXE in a directory along with other
  14. small Windows utilities.
  15.  
  16. To configure WinBiff for your system, start the program, and
  17. select "Setup" from the system menu in the upper left window. In
  18. the dialog box which pops up, enter a suitable polling interval
  19. (how often WinBiff checks your mail file), the full pathname of
  20. the file your mail program creates, and the command to invoke
  21. your mail reader (including any command-line arguments).  The
  22. minimum polling interval is 5 seconds.  (Note for Waffle users:
  23. Waffle creates two mailbox files, a text file with a .f, and an
  24. index file with a .i extension -- specify the .f file for
  25. WinBiff.)  By clicking with the left mouse button in the
  26. appropriate boxes, you may choose the additional options:
  27.  
  28.         o start the program minimized
  29.         o "autosize" the program window
  30.         o show mail headers
  31.         o reverse sort headers by order of arrival
  32.  
  33. The "autosize" option tells WinBiff to display an icon when there
  34. is no mail, and to display a window (with or without headers)
  35. when mail is present.  The reverse sort option is inapplicable,
  36. and its checkbox disabled, unless the show headers option is
  37. selected.
  38.  
  39. You can choose what sound WinBiff will make when new mail is
  40. received, by clicking on the appropriate radio button in the
  41. dialog box.  Choosing "Beep" uses the Windows "Default Beep"
  42. sound.  Choosing "Custom" plays the .WAV file given in the Sound file
  43. field.  The "Test" button allows you to play the sound file
  44. during setup.  (You must have appropriate hardware and/or drivers
  45. installed for this choice to work.  A speaker driver SPEAKER.DRV which
  46. provides adequate results without special hardware is available at many
  47. shareware sites, and is available from the author on request.)
  48.  
  49. For the mail file, mail reader, and sound file fields, clicking on an
  50. adjacent Browse button allows you to pick files from a Windows Common
  51. Dialog box.  The Browse buttons require the Windows 3.1 COMMDLG.DLL.
  52. If you are running Windows 3.0, and do not already have COMMDLG.DLL,
  53. you may obtain a copy at many shareware sites, from Microsoft,
  54. or from the author.
  55.  
  56. If you press the "Save" button, a WINBIFF.INI file is created,
  57. and the values you have given will be recalled when the program
  58. is started subsequently. The WINBIFF.INI file will be placed in
  59. the current directory.
  60.  
  61. You may run multiple copies of WinBiff to monitor multiple mailboxes.
  62. For each mailbox to be monitored, using mkdir, create a directory where
  63. a WINBIFF.INI will be stored.  Then, for each each mailbox, add an item
  64. to a folder in the Windows Program Manager, and give one of the
  65. configuration directories just created as the "Working Directory".
  66. When you save your configuration information, it will be saved in
  67. its own working directory.
  68.  
  69.  
  70. USING WINBIFF
  71. -------------
  72.  
  73. When WinBiff runs minimized, it displays either of two icons.
  74. One icon shows a mailbox with its flag down; the other shows
  75. the same mailbox with its flag raised, and the word "MAIL".
  76. WinBiff switches between these two icons depending on whether
  77. there is mail in the specified mail file.  The arrival of new
  78. mail causes the program to beep.
  79.  
  80. When WinBiff runs in a window, unless the show headers option has
  81. been selected, it displays bitmaps equivalent to the icons.  That
  82. is, there are two bitmaps, one for when there is no mail, and
  83. another for when there is.  If the show headers option has been
  84. selected, and there is mail, the "From:" and "Subject:" lines for
  85. up to 100 messages are displayed in the window. Scrollbars are
  86. provided, allowing scrolling through the headers. Choosing the
  87. reverse sort option displays the headers so that the
  88. latest-arriving message is at the top.
  89.  
  90. The user may force the appearance of the original, no-mail icon
  91. (or bitmap) by selecting "Clear" from the system menu. 
  92.  
  93. To invoke the mail reader, double-click with the
  94. right mouse button on the icon or window.  If the window is
  95. displayed, you may also double-click with the left mouse button
  96. or hit <RETURN>.  The reader is invoked only if you have mail.
  97.  
  98. When WinBiff is iconized or the "show headers" option is set, the
  99. caption reads "WinBiff (mailbox)"; it reads just "mailbox" if
  100. headers are disabled and running as a window -- this is so the
  101. title bar is of reasonable size.  WinBiff's window is resizable;
  102. the bitmaps remain reasonably proportioned regardless of size.
  103.  
  104. WinBiff is a shareware program.  If you use the program in a commercial
  105. setting, or non-commercially on a regular basis, please submit
  106. contributions ($10 suggested) to:
  107.  
  108.         Paul A. Steckler
  109.         48 Hawthorne Street
  110.         Somerville, MA  02144
  111.  
  112. Users who submit $10 or more will receive updates as a uuencoded
  113. .ZIP file by e-mail.
  114.  
  115. You may freely distribute the WinBiff executable file as long as the
  116. executable file is not modified in any way, and as long as this document
  117. accompanies the executable.
  118.  
  119. Disclaimer:  You use WinBiff at your own risk.  All warranties expressed
  120. and implied are disclaimed.  Any damages resulting from the use
  121. of WinBiff shall not result in any liability.
  122.  
  123. E-mail correspondence concerning this program may be submitted to:
  124.  
  125.         steck@ccs.neu.edu
  126.  
  127.  
  128. June 26, 1993
  129.  
  130.